lsrcrelationship

使用 lsrcrelationship 指令,傳回系統可見的遠端副本關係(例如,Metro Mirror、Global Mirror 或主動-主動關係)的簡要清單或詳細視圖。

語法

讀取語法圖表略過語法圖表 lsrcrelationship -filtervalueattribute=value-nohdr-delimdelimiter-filtervalue?object_idobject_name

參數

-filtervalue attribute=value
指定一個以上的過濾器清單。 只會傳回其值符合過濾器屬性值的物件。如果指定容量,也必須包括單位。
註: 某些過濾器容許您在輸入指令時使用萬用字元。在 CLI 中使用萬用字元時,會套用下列規則:
  • 萬用字元是星號 (*)。
  • 指令最多可包含一個萬用字元,並且該萬用字元必須是字串中的第一個或最後一個字元。
  • 使用萬用字元時,必須用雙引號 ("") 將過濾項目括起來。
    lsrcrelationship -filtervalue  "name=md*"
-nohdr
依預設,在簡要樣式視圖中會顯示每個資料直欄的標題,在詳細樣式視圖中則會顯示每資料項目的標題。-nohdr 參數會暫停顯示這些標題。
註: 如果未顯示資料,就不會顯示標題。
-delim delimiter
依預設,在簡要視圖中,會用空格區隔所有資料直欄。每個直欄的寬度都會設為各資料項目的最大寬度。在詳細視圖中,每個資料項目本身都有一列,如果顯示標頭,會用空格來區隔資料與標頭。-delim 參數會置換此行為。-delim 參數的有效輸入為一個單位元組字元。如果您在指令行輸入 -delim :,則會用冒號字元 (:) 來區隔簡要視圖中的所有資料項目;例如,直欄不會出現間距。在詳細視圖中,會用指定的定界字元來區隔資料與其標頭。
object_id | object_name
指定物件的名稱或 ID。當使用這個參數時,會傳回特定物件的詳細視圖,而忽略 -filtervalue 參數所指定的任何值。如果未指定 object_id | object_name 參數,則會以簡要視圖顯示符合過濾需求(以 -filtervalue 參數指定)的所有物件。
-filtervalue?
指定您想要在報告中顯示任一或所有有效過濾器屬性的清單。
  • RC_rel_id
  • RC_rel_name
  • master_system_id
  • master_system_name
  • master_vdisk_id
  • master_vdisk_name
  • aus_system_id
  • aux_system_name
  • aux_vdisk_id
  • aux_vdisk_name
  • primary
  • consistency_group_id
  • consistency_group_name
  • state
  • progress
  • copy_type

如需過濾屬性的相關資訊,請參閱 -filtervalue 參數的屬性

說明

這個指令會傳回系統可見的遠端副本關係(例如 Metro Mirror、Global Mirror 或主動-主動關係)的簡要清單或詳細視圖。

下表提供了在輸出視圖中顯示為資料的屬性的可能值。
表 1. lsrcrelationship 指令的屬性和值
屬性
primary 指出主要關係。值為 masteraux
state 指出關係狀態。
  • consistent_copying
  • inconsistent_stopped
  • inconsistent_copying
  • consistent_stopped
  • consistent_synchronized
  • idling
  • idling_disconnected
  • inconsistent_disconnected
  • consistent_disconnected
progress 指出關係進度。此值必須是 0 到 100 之間的數字(整數)。
cycle_period_seconds 指出多重循環之間的最短週期(秒)。此值必須是 60 到 86400 之間的數字(整數)。預設值為 300。
cycling_mode 指出要使用之 Global Mirror、Metro Mirroring 或主動-主動循環的類型。值為 nonemulti
copy_type 指出副本類型。值包括:
  • metro
  • global
  • activeactive
  • blank
freeze time 指出 YY/MM/DD/HH/MM 格式的時間
status 指出狀態。
  • online,表示關係為線上狀態,並可供存取。如果關係狀態是 ConsistentSynchronizedConsistentCopyingInconsistentCopying,則磁區會抄寫主要磁區所收到的主機 I/O 作業。
  • primary_offline,表示關係中的主要磁區已離線。離線磁區會阻止其他的 I/O 作業,並暫停同步化,直到主要磁區重回線上為止。
  • secondary_offline,表示關係中的次要磁區已離線。對於處於 ConsistentSynchronized 狀態(無變更磁區)的 Global Mirror 關係,以及 Metro Mirror 關係,對主要磁區的額外 I/O 寫入作業將終止此關係。
  • io_channel_offline,表示遠端系統無法存取。對於處於 ConsistentSynchronized 狀態(無變更磁區)的 Global Mirror 關係,以及 Metro Mirror 關係,對主要磁區的額外 I/O 寫入作業將終止此關係。
  • primary_change_offline,表示關係中的主要變更磁區已離線。對於含有變更磁區關係的 Global Mirror,現行 I/O 循環會結束,當主要變更磁區重回線上時,新的 I/O 循環就會開始。
  • secondary_change_offline,表示關係中的次要變更磁區已離線。對於含有變更磁區關係的 Global Mirror,現行 I/O 循環會暫停,當次要變更磁區重回線上時,會回復新的 I/O 循環。
  • change_volumes_needed,表示 HyperSwap® 磁區中的主動-主動關係,或是具有變更磁區關係的 Global Mirror。此外,至少未配置一個變更磁區。
    重要: 抄寫服務不合用。
sync 指出關係是否要同步化。值為 in_syncout_of_sync
master_change_vdisk_name 指出充當關係之主變更磁區的磁區名稱(若未定義則為空白)。
註: 這個欄位識別主磁區的變更磁區(若有配置的話)。對於跨系統關係,如果主要磁區位於其他系統中,則主要變更磁區也位於其他系統中。
aux_change_vdisk_id 指出充當關係之輔助變更磁區的磁區 ID(若未定義則為空白)
註: 這個欄位識別輔助磁區的變更磁區(如果已配置這類磁區的話)。對於跨系統關係,如果輔助磁區是在其他系統中,則輔助變更磁區也是在其他系統中。
aux_change_vdisk_name 指出充當關係之輔助變更磁區的磁區名稱(若未定義則為空白)
註: 這個欄位識別輔助磁區的變更磁區(若有配置的話)。對於跨系統關係,如果輔助磁區是在其他系統中,則輔助變更磁區也是在其他系統中。
bg_copy_priority 未使用。
註: 如果關係或一致性群組是跨系統,且系統夥伴關係已斷線,則 Global Mirror、Metro Mirror 或主動-主動關係和一致性群組的名稱可能會空白。
如果未針對下列任一類型的關係定義主要變更磁區或輔助變更磁區,則會設定 change_volumes_needed 狀態:
  • 副本類型設定為主動/主動
  • 副本類型設定為 global,且 cycling_mode 設定為 multi

當磁區之間的內容已同步(相同),sync 屬性的值會是 in_sync。如果在出現一致(已停止)或閒置中狀態之後,在主要或次要磁區上進行寫入作業,它們將不再同步。

簡要呼叫範例

lsrcrelationship -delim : -filtervalue name=j*

簡要的結果輸出

id:name:master_cluster_id:master_cluster_name:master_vdisk_id:master_vdisk_name:
aux_cluster_id:aux_cluster_name:aux_vdisk_id:
aux_vdisk_name:primary:consistency_group_id:consistency_group_name:state:bg_copy
_priority:progress:copy_type:cycling_mode:freeze_time
45:jrel_AB1:0000020061413ABA:clusterA:45:jdisk_B8:0000020060406746:clusterB:38:j
disk_B1:master:::consistent_stopped:50:metro:none:06/06/27/08/31/37
48:jrel_AB2:0000020061413ABA:clusterA:48:jdisk_A4:0000020060406746:clusterB:41:j
disk_B4:master:::consistent_synchronized:50:metro:none:06/06/27/09/31/37
49:jrel_BA_1:0000020060406746:clusterB:42:jdisk_B5:0000020061413ABA:clusterA:49:j
disk_A5:master:248:jdemo_BA_cons1:consistent_stopped:50:metro:none:06/06/27/10/31/37
50:jrel_BA_2:0000020060406746:clusterB:43:jdisk_B6:0000020061413ABA:clusterA:
50:jdisk_A6:master:248:jdemo_BA_cons1:consistent_stopped:50:metro:none:06/06/27/11/31/37

詳細的呼叫範例

lsrcrelationship -delim : AB_2

詳細的結果輸出

id:9
name:AB_2
master_cluster_id:0000020061413MOE
master_cluster_name:chelseaB
master_vdisk_id:9
master_vdisk_name:stripe9
aux_cluster_id:0000020061413MOE
aux_cluster_name:chelseaB
aux_vdisk_id:10
aux_vdisk_name:stripe9_b
copy_type:activeactive
cycle_period_seconds:300
cycling_mode:multi
primary:master
consistency_group_id:
consistency_group_name:
state:consistent_synchronized
bg_copy_priority:50
progress:
freeze_time:2006/05/05/08/26/46
status:online
sync:in_sync